home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / psys.zip / PSYS.DOC < prev    next >
Text File  |  1991-07-25  |  29KB  |  771 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.               //////   ////// //  //  //////  The Psychological SysOp.
  33.              //   // ///      // // ///      Version 1.00 BETA.
  34.             //////   /////    ////  /////   By Peter G. Zion.
  35.            //          ///    ///     ///  Copyright 1991.
  36.           // ///////////  /// // //////   All rights reserved.
  37.                              //
  38.                             //
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                   Table of Contents
  49.  
  50.  
  51.           What is Psys? . . . . . . . . . . . . . . . . . . . . . . . .   3
  52.  
  53.           Licence . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  54.  
  55.           Credits . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  56.  
  57.           Test Drive  . . . . . . . . . . . . . . . . . . . . . . . . .   3
  58.  
  59.           Remote Use  . . . . . . . . . . . . . . . . . . . . . . . . .   4
  60.  
  61.           Name Macros . . . . . . . . . . . . . . . . . . . . . . . . .   4
  62.  
  63.           Forcing Output  . . . . . . . . . . . . . . . . . . . . . . .   5
  64.  
  65.           Colour Control  . . . . . . . . . . . . . . . . . . . . . . .   5
  66.  
  67.           Log Files . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  68.  
  69.           The Status Line . . . . . . . . . . . . . . . . . . . . . . .   6
  70.  
  71.           Real Chat Mode  . . . . . . . . . . . . . . . . . . . . . . .   6
  72.  
  73.           Typing Speed  . . . . . . . . . . . . . . . . . . . . . . . .   7
  74.  
  75.           Backspace Type  . . . . . . . . . . . . . . . . . . . . . . .   7
  76.  
  77.           Exiting Psys  . . . . . . . . . . . . . . . . . . . . . . . .   7
  78.  
  79.           Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  80.  
  81.           The Language File . . . . . . . . . . . . . . . . . . . . . .   8
  82.                The General Section  . . . . . . . . . . . . . . . . . .   8
  83.                The Response Section . . . . . . . . . . . . . . . . . .   9
  84.                The Random Response Section  . . . . . . . . . . . . .    10
  85.                The Personal Section . . . . . . . . . . . . . . . . .    10
  86.                Text Macros  . . . . . . . . . . . . . . . . . . . . .    11
  87.                Some Notes on the Language File  . . . . . . . . . . .    11
  88.  
  89.           Some Notes on Sharing . . . . . . . . . . . . . . . . . . .    12
  90.  
  91.           Mailing Address . . . . . . . . . . . . . . . . . . . . . .    12
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.           What is Psys?
  101.  
  102.                Psys is  a `semi-intelligent'  SysOp emulation.   Psys takes
  103.           advantage of the unique aspect  of SysOp chat mode that the  user
  104.           cannot tell  who is actually typing on the SysOp side.  Users are
  105.           typically unable to tell the difference between Psys and the real
  106.           SysOp for at least a few  minutes. This comes in handy in several
  107.           situations, including:
  108.  
  109.                - Having to chat with annoying users
  110.                - Having to answer the SAME QUESTIONS OVER AND OVER
  111.                - Using a never-tiring program to make it look like you care
  112.                - When you need a good laugh
  113.  
  114.                Psys  attempts to mimic a  SysOp chat through three factors,
  115.           namely,  making somewhat  intelligent  replies to  what the  user
  116.           types,  imitating a human's  typing, and  imitating a  SysOp chat
  117.           environment.   Psys even works with a  user configurable language
  118.           file.  Best  of all,  Psys captures  it all  to a  log for  later
  119.           reference.
  120.  
  121.                It is important that  you read all of the  documentation for
  122.           Psys thoroughly  before using it on  a remote user  -- that's why
  123.           I've spent time on writing these docs!
  124.  
  125.  
  126.           Licence
  127.  
  128.                Use  of  Psys is  at your  own risk.    The author  takes no
  129.           responsibility for anything  that results from  the use of  Psys,
  130.           except a laugh or two.  No fee may be charged for Psys in any way
  131.           whatsoever, EXCEPT if as part of the file library of a pay BBS.
  132.  
  133.                Psys is free,  although Peter Zion retains  all ownership of
  134.           the program. However, if you wish to give me a  "keep up the good
  135.           work" donation, you can send that  along to the address listed at
  136.           the end of  the documentation.  Any donation of  $15 or more will
  137.           receive, if  requested, a free copy of,  on 5.25" disk and/or the
  138.           magic filename and password to file request at my FidoNet/ImexNet
  139.           node number  (also listed below)  the C/assembly source  code for
  140.           Psys.
  141.  
  142.  
  143.           Credits
  144.  
  145.                Thanks to Scott Dudley, author of Maximus-CBCS, for his help
  146.           in testing the program and finding a few nasty bugs.  Thanks also
  147.           to Eric Vice for his helpful suggestions.
  148.  
  149.  
  150.           Test Drive
  151.  
  152.           Psys Version 1.00        By Peter G. Zion                  Page 3
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.                To give Psys a  `test drive', make  sure all the Psys  files
  161.           are  in your  current directory,  and type  the following  at the
  162.           command line:
  163.  
  164.                PSYS /P0 /J"Hello, @u" /NS"Joe Computer" /NU"<your name>"
  165.  
  166.           and argue to your heart's content.  When you want to exit, either
  167.           type "Go Away" or press [ESC].
  168.  
  169.  
  170.           Remote Use
  171.  
  172.                Although  usable  in local  mode with  the /P0  command line
  173.           parameter, Psys  is designed primarily  for remote  use over  the
  174.           modem.  To communicate over the modem, Psys uses a FOSSIL driver.
  175.           If you plan  to run Psys  from a BBS  that already uses  a FOSSIL
  176.           driver, such as  Maximus or Opus,  then you need not  worry about
  177.           this.  But if you don't normally have a FOSSIL drive loaded, then
  178.           you will  have to do so  before running Psys.   There are several
  179.           FOSSIL drivers available, such as David Nugent's BNU.
  180.  
  181.                There are two command line parameters  that are important to
  182.           the use of Psys remotely: /P (com port) and /B  (baud rate).  The
  183.           parameter  /P must  always be  specified,  and it  is immediately
  184.           followed  by the number of the com  port, with 0 being local mode
  185.           (eg. /P2 means  to use com port 2). The  parameter /B, baud rate,
  186.           needs only to be specified if the previous communications program
  187.           didn't use  the FOSSIL, eg. if you  just loaded the FOSSIL before
  188.           running Psys,  or if  you just  shelled  to DOS  from a  terminal
  189.           program.  The  baud rate is specified immediately after the /B on
  190.           the command line, eg. /B2400 sets it to 2400 baud.
  191.  
  192.  
  193.           Name Macros
  194.  
  195.                The  Psys program uses macros in its language script for the
  196.           SysOp's name,  user's name, and BBS  name.  It is  important that
  197.           these are set  correctly so  that the default  language file  for
  198.           Psys calls users  by their real name.   The names are set  by the
  199.           command line parameter /N, which is followed by a name specifier,
  200.           and then a  name in quotes.   The three possible  name specifiers
  201.           are U for the user's name, S for the  SysOp's name, and B for the
  202.           BBS's name.  For example, /NS"Joe SysOp" sets the SysOp's name to
  203.           "Joe  SysOp",  and /NU"Petey  Zion" will  set  the users  name to
  204.           "Petey Zion".   This  will be used  in several  of the  program's
  205.           default  phrases, such  as "Hello,  @u", where  @u is  the user's
  206.           first name.  See Text Macros on page 11 for a more complete  list
  207.           of usable macros.  Note  that the SysOp name and the BBS name are
  208.           usually  set  permanently  in  the language  file  (see  Language
  209.           File/General Section, page 8).
  210.  
  211.  
  212.  
  213.           Psys Version 1.00        By Peter G. Zion                  Page 4
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.           Forcing Output
  222.  
  223.                There are  two command  line parameters  that force  Psys to
  224.           display messages right when it starts.   The /J"<text>" parameter
  225.           causes  Psys to type  the <text>  before the  user gets  to input
  226.           anything.    For instance,  /J"Hello,  Peter"  will type  "Hello,
  227.           Peter"  and press enter twice before waiting for the user to type
  228.           anything.   The /H"<text>" command sends the string <text> to the
  229.           user  at  full speed  in the  message  colour (which  defaults to
  230.           white,  changeable  through  the  /CM  parameter  --  see  Colour
  231.           Control,  page 5),  and  presses enter  ONCE.   This is  good for
  232.           simulating  "CHAT:  begin."  type  messages  to  make  it  REALLY
  233.           realistic.  For  instance, /H"The SysOp  has arrived!" will  send
  234.           "The SysOp has arrived!" to the user at full speed in the message
  235.           colour.
  236.  
  237.  
  238.           Colour Control
  239.  
  240.                To  make  Psys  work well  with  different  BBS  programs in
  241.           simulating  their chat modes, the  /C switch lets  you change the
  242.           colours that Psys sends and uses.  /C is followed by either U for
  243.           user text, S for SysOp text, or M for message text, which is then
  244.           followed by the colour number.  The 16 colours that Psys supports
  245.           are:
  246.  
  247.                 0 - Black
  248.                 1 - Blue
  249.                 2 - Green
  250.                 3 - Cyan
  251.                 4 - Red
  252.                 5 - Magenta
  253.                 6 - Brown
  254.                 7 - Light Grey   8 - Dark Grey
  255.                                  9 - Light Blue
  256.                                 10 - Light Green
  257.                                 11 - Light Cyan
  258.                                 12 - Light Red
  259.                                 13 - Light Magenta
  260.                                 14 - Yellow
  261.                                 15 - White
  262.  
  263.                The  colours default to yellow for SysOp, cyan for the user,
  264.           and white for the messages -- the chat colours for Maximus.  Note
  265.           that the  only time the user  ever sees the message  colour is if
  266.           you specify a /H (display highlighted text) parameter.
  267.  
  268.                Whether or not the user receives graphics, and what type, is
  269.           determined by the /G parameter.   It is followed by either  0, 1,
  270.           or 2, indicating  monochrome (no colour), ANSI colour, and AVATAR
  271.           colour, respectively.  For instance, /G1  would tell Psys  to use
  272.           ANSI codes to make the colour changes.  Note that this  parameter
  273.           is only effective when Psys is talking to a remote user.
  274.  
  275.  
  276.           Log Files
  277.  
  278.                One  of the best features  of Psys is  the log file support.
  279.           By  default, Psys will capture  the conversation between Psys and
  280.  
  281.           Psys Version 1.00        By Peter G. Zion                  Page 5
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.           the user into  a log  file (defaulting to  "Psys.Log") for  later
  290.           "reference",  useful  for  a good  laugh  as  well  as occasional
  291.           blackmail.  If you  wish to change the name in the  log file, use
  292.           the /L"<logfile>" parameter, where  <logfile> is, you guessed it,
  293.           the log file.   If you do not wish a log at  all, you can use the
  294.           /L<+/-> command, where + turns on the log or - turns it off. Note
  295.           that  these  two  variations on  the  /L  parameter  can be  used
  296.           together: /L+"My.Log" will  turn on the log  and set the  name to
  297.           "My.Log".  Also note that the command /L-"<filename>" is somewhat
  298.           of  a  waste of  command  line  space, and  that  in  the current
  299.           version,  /L+ is somewhat redundant, since the log defaults to on
  300.           anyway.  Oh well.
  301.  
  302.                If at any  time in the session with Psys  you wish to toggle
  303.           the log on  or off, you can press Alt-L: you  will be told of the
  304.           new status of the log, and it's condition of the status line will
  305.           change.
  306.  
  307.  
  308.           The Status Line
  309.  
  310.                While  Psys is operating in  either local or  remote mode, a
  311.           status  line will be continually  displayed on the  bottom of the
  312.           screen.  The status line has the following format:
  313.  
  314.                "<username> * <chatmode> * <logmode> * <datentime>"
  315.  
  316.           where  <username> is the full name of the user, <chatmode> "CHAT"
  317.           if you  are in "real" chat  mode and "NOCHAT" if  you aren't (see
  318.           Real Chat  Mode, page 6), <logmode>  will be "LOG" if  the log is
  319.           open and "NOLOG" if it is  closed, and <datentime> is the current
  320.           date and time (assuming that you have set it correctly).
  321.  
  322.  
  323.           Real Chat Mode
  324.  
  325.                If you feel that you need to give the user a little scare in
  326.           remote  mode, when you press  Alt-C you will  be transported into
  327.           "real" chat mode.   This  chat mode operates  identically to  the
  328.           chat mode of most BBS programs, and the user will not be notified
  329.           of the change.  Here is a possible use of "real" chat mode:
  330.  
  331.                User: Are you a computer?  I think you are.
  332.                Psys: No, I'm a human like most of us.
  333.                User: Ok then, what's one plus one?
  334.  
  335.           Now  the  SysOp sees  that his  program  might be  foiled,  so he
  336.           presses Alt-C, and types:
  337.  
  338.                SysOp:  It's two,  you bozo!   What,  didn't they  teach you
  339.           that?
  340.  
  341.  
  342.           Psys Version 1.00        By Peter G. Zion                  Page 6
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.           ...and  the SysOp  then presses  ESC.   The  user will  gasp with
  351.           amazement and  usually apologize to  the SysOp for  claiming that
  352.           he/she is a silicon sack.  Of course, to exit "real" chat mode at
  353.           any time, just  press ESC. Whether  or not you  are in real  chat
  354.           mode  (in  case you  somehow forget)  is  indicated by  "CHAT" or
  355.           "NOCHAT" on the status line.
  356.  
  357.  
  358.           Typing Speed
  359.  
  360.                Of  course,  not everyone  types the  same.   As  such, Psys
  361.           allows  you to modify the  default typing speed  from the command
  362.           line.  Typing speed is adjusted using three factors: the maximum,
  363.           minimum,  and starting speeds. These  values are set  with the /S
  364.           command line parameter.  /S is followed by either  S, M, or X for
  365.           starting,  minimum,  or maximum,  respectively,  and  it is  then
  366.           followed  by a decimal number  to represent the  speed. Note that
  367.           smaller  numbers are faster, and that the minimum speed, as such,
  368.           must be  a greater  number than the  maximum speed.   The default
  369.           numbers are maximum: 35, minimum: 80, and starting: 50.  A faster
  370.           SysOp might use maximum: 25, minimum: 60, and starting: 40, and a
  371.           slower could make  adjustments in  the opposite  direction.   The
  372.           only real way  to test these is to experiment  with them in local
  373.           mode;  there is no guarantee  that halving the  value will double
  374.           the speed.
  375.  
  376.  
  377.           Backspace Type
  378.  
  379.                Certain   VT-100   emulations   do   not   have  destructive
  380.           backspaces;  as  such, Psys  will  normally send  a  backspace, a
  381.           space, and another backspace  to make sure that the  character is
  382.           cleared.  If you wish to not have  Psys do this, for instance, if
  383.           your BBS program doesn't  do this, then  you can use the  /D<+/->
  384.           parameter to turn this off (-) or on (+).  For instance, /D- will
  385.           turn off the extra space and backspace.
  386.  
  387.  
  388.           Exiting Psys
  389.  
  390.                To exit Psys, either press ESC  or wait for the user to type
  391.           the  default quitting phrase, specified in the language file (see
  392.           Language File, page 8), which defaults to "Go away".
  393.  
  394.  
  395.           Setup
  396.  
  397.                Because  of both the wealth of options available in Psys and
  398.           the number of different BBS packages that exist, setup of Psys is
  399.           left up to the SysOp.  However, because I run a Maximus system, I
  400.           can tell you a little more about how to set it up for Maximus and
  401.           probably Opus  as well.  I  have the file F3.BBS  in my \Max\Misc
  402.  
  403.           Psys Version 1.00        By Peter G. Zion                  Page 7
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.           directory, which consists of the compiled form of the following:
  412.  
  413.                [xtern_run]psys.exe /p%P /j"Hello, @u." /nu"%n" /g%g
  414.                /h"CHAT: begin."[quit]
  415.  
  416.           This tells Maximus to shell and run Psys using the  current port,
  417.           jamming "Hello, <username>" into Psys's first  statement, setting
  418.           the  user name, setting the  graphics mode, and  making Psys send
  419.           "CHAT: begin." in the message colour  full speed when started.  I
  420.           have  my  name and  the  board's name  set  as a  default  in the
  421.           language file (see Language  File/General Section, page 8), so  I
  422.           need not include  them as parameters every time.   Because I have
  423.           named the file F3.BBS,  it will automatically be executed  when I
  424.           press the  F3 key locally.   I'm not  sure that all  BBS programs
  425.           have  this capability, but because of the flexibility of Psys, it
  426.           can usually be implemented in one way or another.
  427.  
  428.  
  429.           The Language File
  430.  
  431.                It is in the language file that the real power of Psys lies.
  432.           By changing the language  file, the true capability of  Psys that
  433.           everything that  it every  says to the  user can  be modified  is
  434.           revealed.   You  can give  it certain  accents, extra  fluency in
  435.           certain  subject areas, and even turn it into an intelligent help
  436.           system if you really want to.  The possibilities are endless.
  437.  
  438.                The language  file is automatically loaded  and processed by
  439.           Psys as  soon as the program  is run.  The  default language file
  440.           that Psys will  search for is "Psys.Lng";  if you wish  to change
  441.           this, use  the /F"<langfile>" parameter, where  <langfile> is the
  442.           path/filename of the language file. The language file  is divided
  443.           into  four sections,  namely, the  General section,  the Response
  444.           section, the  Random Response section, and  the Personal section.
  445.           All blank lines  and lines  starting with a  semicolon (';',  for
  446.           comment lines) in the language file are disregarded.
  447.  
  448.  
  449.           The General Section
  450.  
  451.                This is where most of the basic default information for Psys
  452.           is found. The General section starts with the line:
  453.  
  454.                !Begin General
  455.  
  456.           This tells  the Psys language file parser that the lines up until
  457.           the !End statement  are part  of the General  section.  The  next
  458.           line is  the phrase that, if  found anywhere within a  user input
  459.           line, will cause Psys to end.  For example, the line:
  460.  
  461.                Shut up
  462.  
  463.  
  464.           Psys Version 1.00        By Peter G. Zion                  Page 8
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.           will make Psys end as soon as the user types something with "Shut
  473.           up" in it.  When the user DOES do this, the next line in the file
  474.           is displayed, for example:
  475.  
  476.                Oh so you want me to shut up?  OK, I will then.
  477.  
  478.  
  479.                If the  user says the  same thing twice  in a row,  the next
  480.           line of the language file is displayed, for instance:
  481.  
  482.                Please don't repeat yourself.
  483.  
  484.                The next  three lines of the file give the default values of
  485.           the name macros, in the order of default SysOp name, default user
  486.           name, and default BBS name.  For instance,
  487.  
  488.                Peter Zion
  489.                Joe Average
  490.                Pete's Bar and Grill
  491.  
  492.           Of course, these can  all be changed via command  line parameters
  493.           as well -- but it  is usually useful to set defaults here so that
  494.           you don't have to use the same parameters over and over.
  495.  
  496.                This is all that  is required in the General section, so the
  497.           next  line tells Psys that it is the end and to look for the next
  498.           section:
  499.  
  500.                !End General
  501.  
  502.  
  503.           The Response Section
  504.  
  505.                The next  section  in  the language  file  is  the  Response
  506.           section.  This section is the heart of the Psys language file; it
  507.           tells the computer what specific phrases Psys should look for and
  508.           what to respond to them with.  To start the Response section, use
  509.           the
  510.  
  511.                !Begin Response
  512.  
  513.           directive at the start of a line.
  514.  
  515.                The  format  of  the Response  section  is  simple.   It  is
  516.           separated into groups  of a set of phrases  to look for, followed
  517.           by a  set of  responses to  randomly choose from.   The  computer
  518.           differentiates between  the phrases and the  response because the
  519.           responses  are  offset by  a  whitespace  character [space(s)  or
  520.           tab(s)].  Follows is a possible group in the Response section:
  521.  
  522.                Hello
  523.                Hi
  524.  
  525.           Psys Version 1.00        By Peter G. Zion                  Page 9
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                Yo
  534.                Goodday
  535.                 Hi there! How are you?
  536.                 Goodday and welcome to the great white north!
  537.                 Hello!
  538.  
  539.           In this instance, the  computer will first scan the  user's input
  540.           for either "Hello", "Hi", "Yo", or "Goodday".  If it finds one of
  541.           these,  there is a pretty good chance (there is slight randomness
  542.           of  whether  it will  pick  this  phrase or  another  one  in the
  543.           sentence) that  will randomly  pick one  of  the three  responses
  544.           (offset by  spaces) that follow.   Psys will detect the  end of a
  545.           group of responses by either the  !End Response directive (ending
  546.           the  section),  or  a  line  that  isn't  offset   by  whitespace
  547.           (indicating a new group).
  548.  
  549.  
  550.           The Random Response Section
  551.  
  552.                The  Random Response  section is  a list of  responses which
  553.           Psys will  use when it can't  find any of the  special phrases in
  554.           the Response section.   The  Random Response  section is  started
  555.           with the
  556.  
  557.                !Begin RandomResponse
  558.  
  559.           directive.   The section  consist only of a  list of random lines
  560.           which Psys will pick from, and is terminated by the
  561.  
  562.                !End RandomResponse
  563.  
  564.           directive.  There is no special formatting needed.
  565.  
  566.  
  567.           The Personal Section
  568.  
  569.                The Personal section is used to change the person when using
  570.           the  '*' macro (which indicates  substitution of the  rest of the
  571.           sentence)  in the  Response  section.   The  Personal section  is
  572.           commenced with the
  573.  
  574.                !Begin Personal
  575.  
  576.           directive.   The Personal section has  the structure of a list of
  577.           groups  of two phrases, which  are substituted for  each other in
  578.           the end of sentence mentioned above.  A possible such group could
  579.           be:
  580.  
  581.                You
  582.                Me
  583.                Your
  584.                My
  585.  
  586.           Psys Version 1.00        By Peter G. Zion                 Page 10
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.           Now, if the user typed, for instance,
  595.  
  596.                Can you tell me how to leech your files?
  597.  
  598.           and the computer  looked in  the Response section  and found  the
  599.           entry
  600.  
  601.                Can you
  602.                 Yes, I can *.
  603.  
  604.           the computer would  take everything  AFTER the "Can  you" in  the
  605.           user's  sentence, substitute  every "You"  for a  "Me" and  every
  606.           "Your" for a "My" and  vice versa, substitute the result  for the
  607.           '*' in "Yes, I can *.", and type this  to the user.  The computer
  608.           would end up typing
  609.  
  610.                Yes, I can tell you how to leech my files.
  611.  
  612.           To terminate the Personal section, use the
  613.  
  614.                !End Personal
  615.  
  616.           directive.
  617.  
  618.  
  619.           Text Macros
  620.  
  621.                Psys has several  text macros that  can be substituted  into
  622.           anything in  the Response and  Random Response sections  and will
  623.           substitute for various text strings.
  624.  
  625.  
  626.                @u - The user's first name
  627.                @l - The user's last name
  628.                @f - The user's full name
  629.                @s - The SysOp's first name
  630.                @y - The SysOp's last name
  631.                @m - The SysOp's full name
  632.                @b - The BBS name
  633.                *  - The rest of the sentence after the detected phrase when
  634.                used in Response section
  635.                ~  - Scrap current response and use previous
  636.  
  637.  
  638.           Some Notes on the Language File
  639.  
  640.              1.   The sections of the  language file do not have to be in
  641.                any specific order.   For instance, if you wanted  to have
  642.                the Response section before the General section, Psys will
  643.                have  no problem  with  it.   However,  the order  of  the
  644.                information inside the General section is very  important.
  645.                If  it's not in the right order,  Psys will not be able to
  646.  
  647.           Psys Version 1.00        By Peter G. Zion                 Page 11
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.                detect it but it's  use of the information will  be wrong.
  656.                For instance, if you had the "go away" string in the place
  657.                where the user's name  is supposed to be, Psys  will think
  658.                that  the user's name is "go away" (which could, under the
  659.                right circumstances, loose you some friends).
  660.  
  661.              2.   All  text that  is output  by Psys  is  case sensitive,
  662.                while  all text  that Psys  tries to  detect is not.   For
  663.                instance,  the phrase that Psys  tries to look  for in the
  664.                Response section is not  case sensitive, but the responses
  665.                are.
  666.  
  667.              3.   In the  Random, Random Response, and Personal sections,
  668.                there are no limits  on the number of entries  except your
  669.                memory, with one exception: there can only be a maximum of
  670.                100  phrases for Psys  to search for  in one  group in the
  671.                Response  section.   Normally, the  limit should  never be
  672.                reached;  however, if you  are working  with a  very large
  673.                language file, keep this limit in mind.
  674.  
  675.  
  676.           Some Notes on Sharing
  677.  
  678.                Psys  has been carefully programmed  so that it  can be used
  679.           several  times at once.  For instance,  if you were running a two
  680.           node  BBS system and it happened to be run by a user on each node
  681.           at the same time, there would be no problems -- however, you MUST
  682.           have  SHARE.EXE installed  to  do  this.   Without  having  SHARE
  683.           installed, undefined and possibly  dissasterous things can happen
  684.           (read: I hope you backed up recently).  However, only one copy of
  685.           Psys  can write  to the same  log file  at once.   To solve this,
  686.           either   don't  expect   to  get   transcripts  from   two  nodes
  687.           concurently, or set an alternate log file for each  node with the
  688.           /L command line parameter.
  689.  
  690.  
  691.           Mailing Address
  692.  
  693.                If you would  like to leave  me a comment  about Psys,  need
  694.           help  with a certain aspect of Psys,  or report a bug (God forbid
  695.           one  exists)  then I  can  be  reached at  any  of the  following
  696.           network/snailmail addresses:
  697.  
  698.                BBS       Pete's Bar and Grill - Kingston, Ontario
  699.                          613-531-9801
  700.                FidoNet   1:249/148
  701.                ImexNet   89:487/102
  702.                Home      43 Newcourt Place,
  703.                          Kingston, Ontario,
  704.                          K7M 6Y1  CANADA
  705.  
  706.                Please  make  sure  that  you have  read  the  documentation
  707.  
  708.           Psys Version 1.00        By Peter G. Zion                 Page 12
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.           several times before you send me a question about using  Psys.  I
  717.           probably won't  even respond to  one like "How  do I use  Psys in
  718.           remote mode?".  Would you?
  719.  
  720.                If you would like the  source code, please send a cheque  or
  721.           money  order  for  $15  (US  or  Canadian),  along  with  a  note
  722.           specifying whether you want  a disk with the source  code or just
  723.           the F'req password.
  724.  
  725.                I  would love to hear any comments or suggestions about Psys
  726.           from  you;  the  best suggestion  usually  come  from  the users,
  727.           anyway!
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.           Psys Version 1.00        By Peter G. Zion                 Page 13
  770.  
  771.